home *** CD-ROM | disk | FTP | other *** search
/ Software Explosion / Software Explosion (Fore-Matt Home Computing)(1996).iso / games / workbench / bridge_1.06 / bridge.doc next >
Text File  |  1993-01-01  |  10KB  |  260 lines
  1. ========================================================================
  2. =----------------------- Amiga Bridge v 1.06 --------------------------=
  3. =----------------------------------------------------------------------=
  4. =------------------------ (C) Erik Bergersj÷ --------------------------=
  5. =----------------------------------------------------------------------=
  6. =-------------------------- Documentation -----------------------------=
  7. =----------------------------------------------------------------------=
  8. =--------------------------- 01 Jan 1993 ------------------------------=
  9. ========================================================================
  10.  
  11. What is Amiga Bridge?
  12. ---------------------
  13.  
  14. As you might have guessed, Amiga Bridge is an Amiga program that plays
  15. the game bridge. It supports a subset of the bidding system described
  16. by Eric Jannersten in his books "Bridge frσn grunden" and "Systemet i
  17. ett n÷tskal" (I don't know their english titles, if any).
  18. As far as I know, this is the first non-commercial bridge program
  19. available for the Amiga. In my opinion it compares well with the
  20. commercial ones :-) , especially when the user interface is concerned.
  21. I admit the documentation might be a bit sparse, but who reads lengthy
  22. documentation files anyway?
  23.  
  24.  
  25. Included files
  26. --------------
  27.  
  28. Bridge.doc        This very file.
  29. Bridge.doc.info        Icon to this file.
  30. Normal_Version        Directory for normal (MC68000) version.
  31. -  Bridge        The executable file.
  32. -  Bridge.info        A beautiful icon (guess who made it?).
  33. -  Bridge.prefs        Default settings (not required, save your own).
  34. Normal_Version.info    Icon for directory.
  35. Turbo_Version        Directory for turbo (MC68020) version.
  36. -  Bridge        The executable file, turbo version.
  37. -  Bridge.info        Nice icon for executable.
  38. -  Bridge.prefs        Default settings (not required, save your own).
  39. Turbo_Version.info    Icon for directory.
  40.  
  41. The files below are ⌐ Nico Franτois:
  42. ------------------------------------
  43.  
  44. Install            Installation script, reqtools.library.
  45. Install.info        Icon for installation script.
  46. Install.script        Installation script, continued.
  47. kick20            Directory for reqtools, kick 2.0 version.
  48. -  reqtools.library    The library file.
  49. kick13            Directory for reqtools, kick 1.3 version.
  50. -  reqtools.library    The library file.
  51.  
  52. Distribution
  53. ------------
  54.  
  55. Amiga Bridge v 1.06 is shareware, NOT public domain.
  56.                        ~~~~~~~~~
  57. It may be freely distributed (as long as all files except Bridge.prefs
  58. are included as is) for non-commercial purposes. However, if you decide
  59. to keep it you really should make a contribution.
  60. Write to:    Erik  Bergersj÷
  61.         Fornminnesv. 20
  62.         446 35 ─lvΣngen
  63.         Sweden
  64.  
  65. If possible, send bug-reports to (e-mail) d9erikb@dtek.chalmers.se
  66.                               or          emb@doc.ic.ac.uk
  67.  
  68. Acknowledgements
  69. ----------------
  70.  
  71. I'd like to thank some people for making life easier to live:
  72.  
  73. o Martin Ewaldz        Pascal source to PC bridge (the basics
  74.             for the bidding system).
  75. o Nico Franτois        This version of Amiga Bridge uses reqtools.library
  76.             (⌐ Nico Franτois) for almost all requesters.
  77.  
  78. How hands are valued
  79. --------------------
  80.  
  81. o Honor points (hp).
  82.   ACE => 4 hp, KING => 3 hp, QUEEN => 2 hp, KNIGHT => 1 hp.
  83.   There are a lot of special cases where other values should be
  84.   used. However, for simplicity the special cases are ignored.
  85.  
  86. o Distribution points (dp).
  87.   The calculation of distribution points (as described in the books
  88.   I've read) is complicated. It gives a different number of points
  89.   depending on the progress of the bidding.
  90.   I have chosen a simple approximation:
  91.   All suits with less than 3 cards => (3 - number of cards) dp.
  92.  
  93. o Points (also refered to as "normal points").
  94.   This is the sum of the honor points and the distribution points.
  95.  
  96. o Trick points (tp).
  97.   The number of trick points for a hand depends on the selected trump.
  98.   It represents how many tricks we should be able to secure with
  99.   the specified trump (8 tp <=> 8 probable tricks).
  100.   A table is used to find the offensive value of the honors.
  101.   Suits with more than 3 cards give 0.5 (1 for trump) tp for each
  102.   additional card. Only the integer part is used.
  103.  
  104.   o---------------------o-----------------------o
  105.   | 3        E-K-Q    | 1 1/4        E-Kn-x    |  "x" represents any
  106.   |            |        K-Q-x    |  card less than 10.
  107.   | 2 1/2    E-K-Kn    |            |
  108.   |        E-Q-Kn    | 1        E    |
  109.   |            |        K-Q    |
  110.   | 2 1/4    E-K-10    |        K-Kn-x    |
  111.   |            |        Q-Kn-10    |
  112.   | 2        E-K    |            |
  113.   |        E-Q-10    | 3/4        K-Kn    |
  114.   |        K-Q-Kn    |        K-10-9    |
  115.   |            |            |
  116.   | 1 3/4    E-Kn-10    | 1/2        K-x    |
  117.   |            |        Q-Kn-x    |
  118.   | 1 1/2    E-Q    |        Q-10-9    |
  119.   |        K-Q-10    |            |
  120.   |        K-Kn-10    | 1/4        Q-x    |
  121.   |            |        Kn-10-x    |
  122.   o---------------------o-----------------------o
  123.  
  124.  
  125. The bidding system
  126. ------------------
  127.  
  128. The bidding system is probably the most complex part of Amiga Bridge.
  129. I'm not going to describe it here.
  130. There are two menu items in the "Game" menu ("Opening bids" and
  131. "Response bids") that will help you with details about the implemented
  132. opening & response bids possible.
  133. However, there are other bid classes.
  134.  
  135. o Blackwood (4 NT, 4 NT - ? - 5 NT).
  136.   The first blackwood question asks partner for number of aces,
  137.   the second for number of kings. The second question gives the
  138.   additional information that all the aces are accounted for.
  139.   Amiga Bridge doesn't treat trump king (queen) as an ace (king).
  140.   The responses are:
  141.   4 NT:  5 C <=> 0 or 4 aces, 5 D <=> 1 ace, 5 H <=> 2 aces,
  142.          5 S <=> 3 aces.
  143.   5 NT:  6 C <=> 0 or 4 kings, 6 D <=> 1 king, 6 H <=> 2 kings,
  144.          6 S <=> 3 kings.
  145.  
  146. o Normal bids. A bid that doesn't fit any convention is normal.
  147.  
  148. o Illegal bids. All unsupported bids are illegal. They don't give
  149.   any information whatsoever. The computer never makes illegal bids.
  150.  
  151. To find the correct bid (and to learn the system), experiment!
  152. Make a bid, then select "Display info" from the "Game" menu.
  153. If you made the wrong bid you can always select "Restart" (or
  154. "Restart game" from the "Game" menu) and try again.
  155. You can also select "Auto bidding" from the "Preferences" menu and
  156. bidding will be handled automatically.
  157.  
  158. Preferences
  159. -----------
  160.  
  161. o Computer cheating    When selected, the computer will cheat & look
  162.             at your cards. This results in faster (and
  163.             sometimes better) moves. Normally the computer
  164.             calculates simulated distributions, based on the
  165.             information obtained from bidding.
  166. o Auto bidding        The computer handles the bidding automagically.
  167. o Award honor bonus    In the good old days, bonus points were awarded
  168.             for having all the honors (or all honors in
  169.             trump).
  170. o Delay obvious moves    When an opponent (or your partner, when your
  171.             opponents have claimed a contract) has but one
  172.             card in a suit, the computer doesn't have to
  173.             think, the move is obvious. When this item is
  174.             selected the computer will pretend to think,
  175.             keeping the actual distribution a secret.
  176. o Alternate colors    How do you want your cards to be sorted?
  177.             The hands are not redrawn at once.
  178. o Change colors        Now why would you want to do that?
  179. o Evaluation
  180.   - Number of deals    The number of simulated distributions that should
  181.             be tried. Low values will result in some rash
  182.             moves, but (much) faster evaluation.
  183.             Default setting: 3.
  184.             Personally I use a value of 9. A 25 MHz A3000
  185.             has some benefits...
  186.   - Weight, heuristics    The weight for the heuristic part of the evaluation.
  187.               Amiga Bridge makes a (clever?) guess about the
  188.               best card to play. Default setting: 3.
  189.   - Weight, search    The weight for the search part of the evaluation.
  190.               Each card is tried in turn, the max/min number
  191.               of won tricks is calculated. Default setting: 9.
  192.  
  193. History
  194. -------
  195.  
  196. 09 Dec 1991    First released version (1.0 ▀) uploaded to ab20.
  197.  
  198. 27 Dec 1991    Changed from req.library to reqtools.library. Added
  199.         some opening conventions (highest of sequence, rule 11,
  200.         ...). Some bugs in bidding system fixed.
  201.  
  202. 03 Jan 1992    Added code to handle NTSC machines. Unless a PAL screen
  203.         can be opened (with kickstart 1.x I don't know how to
  204.         do that on an NTSC machine) the program will abort.
  205.         Added options 'Delay obvious moves' and
  206.         'Alternate colors'. Version 1.01, uploaded to ab20.
  207.  
  208. 06 Jan 1992    Added support for NTSC machines.
  209.         Kickstart 2.0: If the required hardware is present and
  210.                    a PAL monitor driver is installed, a
  211.                    PAL screen is opened.
  212.                    Note: a PAL monitor driver MUST be present,
  213.                    place PAL in WBStartup!
  214.         Kickstart 1.3: If the required hardware is present Amiga
  215.                    Bridge will ask the user if a PAL or an
  216.                    NTSC screen should be opened.
  217.         Some bugs fixed.
  218.  
  219. 16 Jan 1992    Some code optimizations. Added options to load / save
  220.         distributions. Version 1.02, uploaded to ab20.
  221.  
  222. 20 Jan 1992    Removed the option to switch to PAL on NTSC machines
  223.         running kickstart 1.3. A reset seems to be required to
  224.         make it work properly on all machines.
  225.         I don't like the idea of user-software making resets -
  226.         use a stand-alone PAL converter instead.
  227.         Also, the "normal" version should work with an MC68000
  228.         this time. The last one didn't (due to an error in my
  229.         makefile; one file was optimized for MC68020 => GURU).
  230.         Stupid mistake.    Version 1.03, uploaded to ab20.
  231.  
  232. 06 May 1992    Fixed some minor bugs. I have been working with other
  233.         things lately and I don't think I'll find any time
  234.         for Amiga Bridge for quite a while.
  235.         That's why I choose to upload this version, even if
  236.         there are only minor improvements.
  237.         Perhaps if some people registered... (hint, hint :-) ).
  238.         Version 1.04.
  239.  
  240. 19 Dec 1992    Mostly changes in the user interface, added possibility
  241.         to iconify. Some small changes in bidding and playing.
  242.         Version 1.05.
  243.  
  244. 01 Jan 1993    Changed compiler. Extensive optimisations in the bidding
  245.         and playing code. Fixed some rather serious bugs,
  246.         one of which caused the program to discard high cards
  247.         instead of low... Version 1.06.
  248.  
  249. Comments:
  250. ---------
  251.  
  252. o In NTSC mode, only the upper half of the cards is displayed.
  253.   This makes it difficult to recognise some cards.
  254.   I don't intend to fix this. The risk for playing the wrong card is
  255.   small and there is always the Undo function.
  256. o Extensively tested with enforcer (no results - yet).
  257.  
  258.  
  259. ========================================================================
  260.